home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / pcboard / sat114.zip / SAT.DOC < prev    next >
Text File  |  1994-05-31  |  34KB  |  866 lines
  1. ╓─────────────────────────────────────────────────────────────────────────────╖
  2. ║ ░░░░░ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  3. ╙─────────────────────────────────────────────────────────────────────────────╜
  4.  
  5.  
  6. ╓─────────────────────────────────────────────────────────────────────────────╖
  7. ║ ░░░░░ SAT Version 1.14 Documentation ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  8. ╙─────────────────────────────────────────────────────────────────────────────╜
  9.  
  10. Introduction:
  11.  
  12. SAT is a program for handling the daily influx of files from the
  13. Planet Connect satellite system.  The main purpose of the program is
  14. to move received files to processing directories and keep track of
  15. what has and has not been received.
  16.  
  17. Additional Features Include:
  18.  
  19.  - TIC File processing
  20.    - Match .TIC file to distribution file
  21.    - Move processed distribution files to another directory
  22.    - Move or optionally delete .TIC files
  23.    - Produce a PCBoard style directory of received distribution files
  24.    - The PCBoard style directory is highly customizable including:
  25.      - Addition of file distribution area to description
  26.      - Starting the description on the same line as the file name
  27.      - Justify the description Right or Left on the line
  28.      - Optional single whitespace the description
  29.      - Optional Strip high ASCII
  30.      - Optional Wordwrap, with specified wraplength
  31.      - Selectable number of line before and after the description
  32.    - Optional search for FILE_ID.DIZ and/or DESC.SDI files for
  33.      distribution file descriptions.
  34.    - Optional insertion of FILE_ID.DIZ files where they do not exist
  35.      using .TIC description text.
  36.    - Parameterized Archiver commands for extraction/insertion to
  37.      handle differing archivers. Commands for
  38.      ZIP/ARJ/ARC/SDN/PAK/LHA/LZH supplied.
  39.  
  40.  - Selectable file moving methods
  41.    - DELETE, always delete
  42.    - NEWER, move only if newer, otherwise delete.  Delete older files.
  43.    - RENAME, move only if newer, otherwise delete. Rename older files.
  44.    - ALERT, like RENAME, but also write a message to a selectable msg 
  45.      base alerting that a new file has appeared.
  46.    - MOVE, always move.
  47.  
  48.  - Up to 100 From/To directory pairs for file moving, with wildcard
  49.    specification.
  50.  
  51.  - User definable COPY program for across drive moving of files (for
  52.    NOVELL systems, this would be the NCOPY.EXE program).
  53.  
  54.  - Selectable logging levels:
  55.    1(Error), 2(Warning), 3(Major Info), 4(Minor Info), 5(Who Cares)
  56.  
  57.  - Write a PCBoard message to the Sysop when an error occurs (optional)
  58.  
  59.  - Usenet BAG handling
  60.    - Unzipping of BAGs
  61.    - Elimination of unwanted newsgroups from BAGs
  62.    - Optional Tracking of Unknown Newsgroups
  63.    - Optional Newsgroup Statistics (Msgs, Bytes)
  64.    - Optional Culled Newsgroup Statistics (Msgs, Bytes)
  65.  
  66.  - UPLD.LST processing
  67.    - Tracking of received files versus what is being sent
  68.    - Tracks number times a files has been received
  69.    - FREQ list production, new or cumulative, Manual or Automatic.
  70.    - Definable Errorlevel exit when files are to be FREQ'd
  71.    - Data held in industry standard .DBF files for easy interface
  72.    - Build/Index/Purge/Check the databases
  73.    - Automatic or Manual Purging of old data
  74.  
  75. ╓─────────────────────────────────────────────────────────────────────────────╖
  76. ║ ░░░░░ Program Installation ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  77. ╙─────────────────────────────────────────────────────────────────────────────╜
  78.  
  79. Unzip everything in a directory where you would like SAT to run. 
  80.  
  81. Ensure that the usual PCBoard environment variables are present for
  82. access to PCBOARD.DAT (SET PCBDAT=xxxxxx).
  83.  
  84. Alter the configuration file to your tastes and system.
  85.  
  86. Run SAT -once- with the Parameter "BUILD".  This will create your
  87. starting databases and indexes.
  88.  
  89. Decide when and how you want SAT to run (manually? in event?) and
  90. insert the appropriate statements into your selected process.
  91.  
  92. Run it!  It is suggested you -not- run with ALERT until you've run
  93. long enough to build prior file instances.
  94.  
  95. ╓─────────────────────────────────────────────────────────────────────────────╖
  96. ║ ░░░░░ Sample Usage ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  97. ╙─────────────────────────────────────────────────────────────────────────────╜
  98.  
  99. Typically I use SAT as a once-an-hour process on a dedicated batch
  100. process server.  Here is the batch file run:
  101.  
  102.  
  103. @ECHO OFF
  104. H:
  105. cd\pc\sat
  106.  
  107. SAT MOVE
  108. SAT TIC
  109.  
  110. :FIDO
  111. if not exist H:\pc2\fido\mail\0*.* goto UNINET
  112. f:
  113. cd\qf
  114. qscan /CNODE100 /BOTH
  115.  
  116. :UNINET
  117. if not exist H:\pc2\uninet\LEDGE.* goto RIME
  118. p:
  119. cd\doors\cammail
  120. export ledge /TOP
  121. import ledge /KILLQWK /LOG
  122.  
  123. :RIME
  124. if not exist H:\pc2\rime\*.ZIP goto WEATHER
  125. p:
  126. cd\postlink
  127. postlink altimp.cfg /altimport
  128.  
  129. :WEATHER
  130. if not exist h:\pc2\weather\*.arc goto FINI
  131. h:
  132. cd \pc2\weather
  133. mv *.arc \f\weather\work /O
  134. cd \f\weather\work
  135. pkunzip *.arc
  136. del *.arc
  137. fname *.PCX "pkzip -m %%f %%s">doit.bat
  138. call doit
  139. del doit.bat
  140. mv *.zip \f\weather /O
  141.  
  142. :FINI
  143. cls
  144.  
  145.  
  146. ╓─────────────────────────────────────────────────────────────────────────────╖
  147. ║ ░░░░░ Program Commandline Parameters ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  148. ╙─────────────────────────────────────────────────────────────────────────────╜
  149.  
  150.   Usage:
  151.   
  152.      SAT <action> [Cfg=cfgfile]
  153.   
  154.         where <action> (required) is the action to take
  155.               or "?" for extended information.
  156.   
  157.         where [Cfg=cfgfile] (optional) is the configuration file
  158.               to use.  All PCBoard Professional Sysop Series (PPSS) 
  159.               programs and packages operate out of a unified 
  160.               configuration file called PPSS.CFG.  See CONFIG.DOC
  161.               for general information on PPPS.CFG files.
  162.  
  163.      <action> can be one of
  164.  
  165.        BUILD - Builds the databases files for file tracking (initial run).
  166.        INDEX - (re)Indexes the data files.
  167.        CHECK - Xrefs current files against the file tracking databases.
  168.        MOVE  - Moves, deletes, etc. files per configuration.
  169.        FREQ  - Constructs list of files not received.
  170.        PORP  - Culls USENET Bag files per wanted newsgroups.
  171.        TIC   - TIC file processing, directory construction.
  172.        PACK  - Pack databases, usually not done manually.
  173.        PURGE - Purge records per date parms in Cfg, Pack.
  174.  
  175.        Note: "PORP" is a joke. :-)
  176.  
  177. ╓─────────────────────────────────────────────────────────────────────────────╖
  178. ║ ░░░░░ Example Configuration File format ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  179. ╙─────────────────────────────────────────────────────────────────────────────╜
  180.  
  181.   ;═══════════════════════════════════════════════════════════════════════════
  182.   ;PCBoard Professional Sysop Series
  183.   ;═══════════════════════════════════════════════════════════════════════════
  184.  
  185.   ;───────────────────────────────────────────────────────────────────────────
  186.   [PPSS General Configuration]
  187.   ;───────────────────────────────────────────────────────────────────────────
  188.  
  189.   Version=120
  190.  
  191.   BBSName=Mushin BBS
  192.   BBSSlogan=Join the InfoMushin Age!
  193.   SysopName=Brad Chesbro
  194.   PKZIP=PKZIP.EXE
  195.   PKUNZIP=PKUNZIP.EXE
  196.   TextEditor=B.EXE
  197.   MsgWriter=TXT2MSG.EXE
  198.   NetworkCopy=NCOPY.EXE
  199.  
  200.   ;───────────────────────────────────────────────────────────────────────────
  201.   [SAT File Handler Configuration]
  202.   ;───────────────────────────────────────────────────────────────────────────
  203.  
  204.   ; Version, Registration, Nodes Supported
  205.  
  206.   Version=110
  207.   RegisteredName=Bradley Chesbro
  208.   RegistrationNumber=0
  209.   NodesSupported=100
  210.  
  211.   ; UPLD.LST and tracking databases/indexes
  212.  
  213.   RawUpldLst=H:\PC\SKY\UPLD.LST
  214.   UpldDbf=SATUPLD.DBF
  215.   UpldIdx=SATUPLD.IX1
  216.   ULstIdx=SATUPLD.IX2
  217.   MoveDbf=SATMOVE.DBF
  218.   MoveIdx=SATMOVE.IX1
  219.   
  220.   ; Usenet Newsgroup BAG Processing
  221.  
  222.   BagDir=H:\PC2\NEWSGRP
  223.   GroupKeepList=KEEPME.LST
  224.   ListUnknownNewsgroups=NO
  225.   ListNewsgroupStatistics=YES
  226.  
  227.   ; File Receival tracking/notification
  228.  
  229.   FreqFile=SATFREQ.NOW
  230.   FreqSuffix=FRQ
  231.   NeedToFreqExitErrorLevel=1
  232.  
  233.   ; TIC file processing
  234.  
  235.   TicTICSAreIn=H:\PC2\FIDO\FILES
  236.   TicFilesAreIn=H:\PC2\FIDO\FILES
  237.   MoveTicTICSTo=H:\TICS\IN
  238.   MoveTicFilesTo=H:\TICS\IN
  239.   DeleteProcessedTICs=NO
  240.   PCBFileDirectory=SATMOVE.FIL
  241.  
  242.   ; No refit, standard PCBoard style
  243.   StartSameLine=YES
  244.   JustifyRight=YES
  245.   SingleWhite=NO
  246.   StripHigh=NO
  247.   WordWrap=NO
  248.   WrapLength=45
  249.   BlankLinesAfterName=0
  250.   BlankLinesAfterDesc=0
  251.  
  252.   TicAreaTag=FDNArea:
  253.   UseDIZIfAvailable=YES
  254.   UseSDIIfAvailable=YES
  255.   LogNoDIZOrSDI=NO 
  256.   AddTICDescAsDIZIfNoDIZ=YES
  257.   Archive=ARC;PkUnPak.Exe -xr    %s FILE_ID.DIZ
  258.   Archive=PAK;Pak.Exe e /wa /st  %s FILE_ID.DIZ
  259.   Archive=ZOO;Zoo.Exe xo         %s FILE_ID.DIZ
  260.   Archive=ZIP;PkunZip.Exe -o -ed %s FILE_ID.DIZ
  261.   Archive=LHA;LHa.Exe e -m1      %s FILE_ID.DIZ
  262.   Archive=LZH;LHa.Exe e -m1      %s FILE_ID.DIZ
  263.   Archive=ARJ;Arj.Exe e -y       %s FILE_ID.DIZ
  264.   Archive=SDN;Arj.Exe e -y       %s FILE_ID.DIZ
  265.   Archive=SQZ;Sqz.Exe e /p3o1    %s FILE_ID.DIZ
  266.  
  267.   ; General Maintenance, logging and messages
  268.  
  269.   PurgeDays=5
  270.   NoPurgeList=NOPURGE.LST
  271.   SysopLog=SYSOP.LOG
  272.   Loglevel=5
  273.   ProgramErrorMsg=PROGERR.MSG
  274.   ProgramAlertMsg=PROGALRT.MSG
  275.   SysopMsgBase=0
  276.  
  277.   ; File moving
  278.  
  279.   ;    FromDir        ToDir               Wildcard   Method
  280.  
  281.   Move=H:\PC\CELEPUB  H:\PC2\CELEPUB          *.*    NEWER
  282.   Move=H:\PC\CONNECT  H:\PC2\SKY\INFO         *.QIF  ALERT
  283.   Move=H:\PC\CONNECT  H:\PC2\CONNECT          *.*    RENAME
  284.   Move=H:\PC\CRS      H:\PC2\SKY\INFO         *.QIF  ALERT
  285.   Move=H:\PC\CRS      H:\PC2\CRS              *.*    RENAME
  286.   Move=H:\PC\FIDO     H:\PC2\FIDO\MAIL 0000FFFF.*    NEWER
  287.   Move=H:\PC\FIDO     H:\PC2\FIDO\CDN      CDN*.*    NEWER
  288.   Move=H:\PC\FIDO     H:\PC2\FIDO\FAM     FMLY*.*    NEWER
  289.   Move=H:\PC\FIDO     H:\PC2\FIDO\FILES       *.*    NEWER
  290.   Move=H:\PC\FRENCH   H:\PC2\FRENCH           *.*    NEWER
  291.   Move=H:\PC\FUTURE   H:\PC2\FUTURE           *.*    NEWER
  292.   Move=H:\PC\GALAXY   H:\PC2\SKY\INFO         *.QIF  ALERT
  293.   Move=H:\PC\GALAXY   H:\PC2\GALAXY           *.*    NEWER
  294.   Move=H:\PC\GLOBAL   H:\PC2\SKY\INFO         *.QIF  ALERT
  295.   Move=H:\PC\GLOBAL   H:\PC2\GLOBAL           *.*    RENAME
  296.   Move=H:\PC\HCN      H:\PC2\HCN              *.*    RENAME
  297.   Move=H:\PC\INTELEC  H:\PC2\SKY\INFO         *.QIF  ALERT
  298.   Move=H:\PC\INTELEC  H:\PC2\INTELEC          *.*    RENAME
  299.   Move=H:\PC\NEWSGRP  H:\PC2\SKY\PERS  PCUSENET.TXT  ALERT
  300.   Move=H:\PC\NEWSGRP  H:\PC2\NEWSGRP          *.*    NEWER
  301.   Move=H:\PC\PROSTAR  H:\PC2\PROSTAR          *.*    NEWER
  302.   Move=H:\PC\RIME     H:\PC2\RIME             *.*    NEWER
  303.   Move=H:\PC\ROSENET  H:\PC2\SKY\INFO         *.QIF  ALERT
  304.   Move=H:\PC\ROSENET  H:\PC2\ROSENET          *.*    NEWER
  305.   Move=H:\PC\SKY\PERS H:\PC2\FIDO\FILES ALLTICS.*    RENAME
  306.   Move=H:\PC\SKY\PERS H:\PC2\SKY\PERS         *.*    ALERT
  307.   Move=H:\PC\SKY\SKY  H:\PC2\SKY\SKY       UPLD.LS*  NEWER
  308.   Move=H:\PC\SKY\SKY  H:\PC2\SKY\SKY          *.*    NEWER
  309.   Move=H:\PC\TV       H:\PC2\TV               *.*    NEWER
  310.   Move=H:\PC\UNINET   H:\PC2\SKY\INFO         *.QIF  ALERT
  311.   Move=H:\PC\UNINET   H:\PC2\UNINET           *.*    RENAME
  312.   Move=H:\PC\USATODAY H:\PC2\USATODAY         *.*    RENAME
  313.   Move=H:\PC\WEATHER  H:\PC2\WEATHER          *.*    NEWER
  314.   Move=H:\PC\ILINK    H:\PC2\ILINK            *.*    NEWER
  315.  
  316. ╓─────────────────────────────────────────────────────────────────────────────╖
  317. ║ ░░░░░ NetworkCopy ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  318. ╙─────────────────────────────────────────────────────────────────────────────╜
  319.  
  320. This line is used to specify a network specific COPY if it is appropriate
  321. for your network.  This option was put in place purely for those networks
  322. (NOVELL for example) that have a network compatible copy that accomplishes
  323. it's work by instructing the server to do the copy without having the file
  324. actually travel up the network wire to the workstation and back down.  In
  325. a future version of SAT it is hoped to make the NOVELL copy internal using
  326. proper NOVELL API calls.
  327.  
  328. You can put just COPY, and let DOS do the copy, or put INTERNAL, and let
  329. SAT do the copy internally. 
  330.  
  331. ╓─────────────────────────────────────────────────────────────────────────────╖
  332. ║ ░░░░░ Messages ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  333. ╙─────────────────────────────────────────────────────────────────────────────╜
  334.  
  335. If you want to disable a particular message from being sent, leave
  336. that line blank, i.e.
  337.  
  338.   ProgramErrorMsg=
  339.   ProgramAlertMsg=
  340.  
  341. A message is simply text; the To/From and Subject are currently 
  342. program-controlled.
  343.  
  344. ╓─────────────────────────────────────────────────────────────────────────────╖
  345. ║ ░░░░░ Databases ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  346. ╙─────────────────────────────────────────────────────────────────────────────╜
  347.  
  348. Databases used by SAT are industry standard .DBF databases.  The
  349. indexes are proprietary.  You may name and place the databases and
  350. indexes however you like.
  351.  
  352. Database naming and placement parameters:
  353.  
  354.   UpldDbf=
  355.   UpldIdx=
  356.   ULstIdx=
  357.  
  358.   MoveDbf=
  359.   MoveIdx=
  360.  
  361.  
  362. ╓─────────────────────────────────────────────────────────────────────────────╖
  363. ║ ░░░░░ Version Control ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  364. ╙─────────────────────────────────────────────────────────────────────────────╜
  365.  
  366. PPSS programs keep track of Configuration file version so that they
  367. can complain if the configuration file needs to be updated for a new
  368. version.  Parameter:
  369.  
  370.   Version=
  371.  
  372. ╓─────────────────────────────────────────────────────────────────────────────╖
  373. ║ ░░░░░ Registration ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  374. ╙─────────────────────────────────────────────────────────────────────────────╜
  375.  
  376. Registration is -not- necessary for full and complete running of the
  377. SAT program; in fact registration is -free- for a phone call.  See
  378. "REGISTER.DOC" for full information.  Until registered, these
  379. parameters can be anything:
  380.  
  381.   RegisteredName=
  382.   RegistrationNumber=
  383.   NodesSupported=
  384.  
  385. ╓─────────────────────────────────────────────────────────────────────────────╖
  386. ║ ░░░░░ Files Received Tracking ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  387. ╙─────────────────────────────────────────────────────────────────────────────╜
  388.  
  389. These parameters are used to keep track of files that should be
  390. received, which have been received, and those which have not been
  391. received and which must be procured by "non-satellite means".
  392.  
  393.   RawUpldLst=
  394.  
  395.    Points to the directory where "UPLD.LST" can be found.
  396.  
  397.   FreqFile=
  398.  
  399.    Desired name for the file that lists unreceived files for
  400.    a "SAT FREQ" adhoc run.
  401.  
  402.   FreqSuffix=
  403.  
  404.    Desired suffix for the daily "Unreceived this date" file.
  405.    The filename is YY-MM-DD.ext
  406.  
  407.   NeedToFreqExitErrorLevel=
  408.  
  409.    After the automatic production of the "unreceived this date"
  410.    file, the program will exit with this error level for batch
  411.    file purpose.
  412.  
  413. ╓─────────────────────────────────────────────────────────────────────────────╖
  414. ║ ░░░░░ Usenet BAG processing ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  415. ╙─────────────────────────────────────────────────────────────────────────────╜
  416.  
  417. Usenet BAG processing is designed to unzip and strip from the .BAG
  418. files those messages from newgroups you do not wish to carry. A work
  419. directory beneath the BAG directory is created and deleted.
  420.  
  421. Press Escape during BAG processing and the program will ask if you
  422. wish to terminate processing at this time.  Processing will be
  423. terminated gracefully.  The work directory will be deleted.  No data
  424. is lost.
  425.  
  426.   BagDir=
  427.  
  428.    Where the zipped BAG files can be found.
  429.  
  430.   GroupKeepList=
  431.  
  432.    The Usenet newsgroups you wish to retain
  433.  
  434.   ListUnknownNewsgroups=
  435.  
  436.    The program will optionally list newgroups you have not
  437.    listed.  Not recommended at this time.  Leave blank to
  438.    bypass this list.
  439.  
  440.   ListNewsgroupStatistics=
  441.  
  442.    The program will optionally list message statistics for the
  443.    newsgroups you are keeping.
  444.  
  445. ╓─────────────────────────────────────────────────────────────────────────────╖
  446. ║ ░░░░░ TIC file processing ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  447. ╙─────────────────────────────────────────────────────────────────────────────╜
  448.  
  449. This is an somewhat complicated area.  You can process/match TIC
  450. files to the files they name, while deleting or moving the TIC files.
  451. You can create a PCBoard compatible directory of the files that are
  452. matched to, using either the TIC supplied description (the program
  453. will automatically detect and use lDesc in preference to Desc in this
  454. case) or use the FILE_ID.DIZ/DESC.SDI files if present.  There are
  455. numerous possibilites for formatting the PCBoard dir file.
  456.  
  457.   TicTICSAreIn=
  458.   TicFilesAreIn=
  459.  
  460.     Where the TIC files and the distribution files are,
  461.     -after- being "SAT MOVE"'d.
  462.  
  463.   DeleteProcessedTICs=
  464.  
  465.     YES or NO
  466.  
  467.   MoveTicTICSTo=
  468.   MoveTicFilesTo=
  469.  
  470.     Move the Processed TIC files and distribution to a
  471.     "processed" directory.  This will keep them from being 
  472.     processed more than once...
  473.  
  474.   PCBFileDirectory=
  475.  
  476.     Drive\Path\Name of the text file to add descriptions to.
  477.  
  478.   TicAreaTag=
  479.  
  480.     A non-blank specification here will add one line to the
  481.     file description of the text specified here followed by one
  482.     blank and the TIC area. Example, "FDNArea: PCBUTIL".
  483.  
  484.   UseDIZIfAvailable=
  485.   UseSDIIfAvailable=
  486.  
  487.     YES or NO for each.  You may not want to take the time to
  488.     process the files at this time.
  489.  
  490.   LogNoDIZOrSDI=
  491.  
  492.     Log those file that do -not- have an override description
  493.     FILE_ID.DIZ or DESC.SDI
  494.  
  495.   Archive=
  496.  
  497.     Specification of file extent and archiver parameters. The first
  498.     characters of the parameters should be the file extent that
  499.     specifies this archiver, followedby s semi-colon.  The text
  500.     following is that which you would use to extract the description
  501.     files from the archive, with the position where the name of the
  502.     archive denoted by "%s" (lower case s).  You can if you wish
  503.     specify a complete drive and path to the archiver, but you
  504.     must specify all slashes (\) as two slashes (\\). As an example:
  505.  
  506.     Archive=ZIP;C:\\UTIL\\PkunZip.Exe -o -ed %s FILE_ID.DIZ
  507.  
  508.     In the sample configuration is:
  509.  
  510.     Archive=ARC;PkUnPak.Exe -xr    %s FILE_ID.DIZ DESC.SDI
  511.     Archive=PAK;Pak.Exe e /wa /st  %s FILE_ID.DIZ DESC.SDI
  512.     Archive=ZOO;Zoo.Exe xo         %s FILE_ID.DIZ DESC.SDI
  513.     Archive=ZIP;PkunZip.Exe -o -ed %s FILE_ID.DIZ DESC.SDI
  514.     Archive=LHA;LHa.Exe e -m1      %s FILE_ID.DIZ DESC.SDI
  515.     Archive=LZH;LHa.Exe e -m1      %s FILE_ID.DIZ DESC.SDI
  516.     Archive=ARJ;Arj.Exe e -y       %s FILE_ID.DIZ DESC.SDI
  517.     Archive=SDN;Arj.Exe e -y       %s FILE_ID.DIZ DESC.SDI
  518.     Archive=SQZ;Sqz.Exe e /p3o1    %s FILE_ID.DIZ DESC.SDI
  519.  
  520.   StartSameLine=
  521.   JustifyRight=
  522.   SingleWhite=
  523.   StripHigh=
  524.   WordWrap=
  525.   WrapLength=
  526.   BlankLinesAfterName=
  527.   BlankLinesAfterDesc=
  528.  
  529.     These parameters are used to determine the format of the 
  530.     PCBoard directory entries created by SAT.  The placement
  531.     of the Filename, size, and date are fixed; everything else
  532.     is up for grabs.
  533.  
  534.     StartSameLine (YES/NO) indicates whether the description is to
  535.     start on the same line as the Filename or on some following line.
  536.  
  537.     Justify right (YES/NO) indicates whether the description, after
  538.     any wordwrap, should be snug against the right side of the screen
  539.     or the left side.
  540.  
  541.     StripHigh (YES/NO) will strip ansi characters above decimal 127,
  542.     and also those below a space ().
  543.  
  544.     SingleWhite (YES/NO) strips excess spaces and linefeeds from the 
  545.     description.
  546.  
  547.     WordWrap (YES/NO) indicates to submit the description to wordwrap
  548.     or leave it "as found".  The program will always wordwrap Desc
  549.     (from the TIC file) as this will sometimes go over the usual 
  550.     standard PCBoard description length.
  551.  
  552.     WrapLength (number) is the number of characters to wordwrap at.
  553.     PCBoard standard is 45.
  554.  
  555.     BlankLinesAfterName, BlankLinesAfterDesc indicate to produce
  556.     "attached" blank lines directly after the Filename line (before
  557.     the description) and directly after the description.  "Attached"
  558.     blank lines are lines that contain the description lines of "|"
  559.     and nothing else.
  560.  
  561.     The following produces a standard PCBoard directory, using the 
  562.     description as intended by the program author.
  563.  
  564.     ; No refit, standard PCBoard style
  565.     StartSameLine=YES
  566.     JustifyRight=YES
  567.     SingleWhite=NO
  568.     StripHigh=NO
  569.     WordWrap=NO
  570.     WrapLength=45
  571.     BlankLinesAfterName=0
  572.     BlankLinesAfterDesc=0
  573.  
  574. DMPC211.ZIP     50852  04-11-94  ╒══════════════════════════════╕
  575.                                | │ Dual Module Player Companion │
  576.                                | │    ⌐  ∙ Version 2.11 ∙  ¬    │
  577.                                | ╞═══────∙·· ·      · ··∙────═══╡
  578.                                | │ DMPC is a front end for  DMP │
  579.                                | │ and other players.  DMPC can │
  580.                                | │ read  files  inside ARJ/ZIP/ │
  581.                                | │ LHA/LIMIT and SQZ  archives. │
  582.                                | │ Supports all known formats!! │
  583.                                | │ Allows  random  and   tagged │
  584.                                | │ playing.  Mouse support, EMS │
  585.                                | │ or  disk swapping,  multiple │
  586.                                | │ configs,  a sample ripper &  │
  587.                                | │ previewer for MOD, S3M, STM, │
  588.                                | │ 669,  MTM,  ULT,  FAR  & AMF │
  589.                                | │ formats.   Rips samples into │
  590.                                | │ SMP, RAW, WAV,  SND and VOC. │
  591.                                | │ Multiple Directory Support!! │
  592.                                | ╞═══────∙·· ·      · ··∙────═══╡
  593.                                | │ I need support  from the BBS │
  594.                                | │ community,  email  me if you │
  595.                                | │ can help distro DMPC for me. │
  596.                                | ╘══════════════════════════════╛
  597.  
  598.  
  599.     The following produces a standard PCBoard directory, wordwrapping
  600.     the description.  Not recommended.
  601.  
  602.     ; Total refit, standard PCBoard style
  603.     ;StartSameLine=YES
  604.     ;JustifyRight=YES
  605.     ;SingleWhite=YES
  606.     ;StripHigh=NO
  607.     ;WordWrap=YES
  608.     ;WrapLength=45
  609.     ;BlankLinesAfterName=0
  610.     ;BlankLinesAfterDesc=0
  611.  
  612. DMPC211.ZIP     50852  04-11-94  ╒══════════════════════════════╕ │ Dual
  613.                                | Module Player Companion │ │    ⌐  ∙ Version
  614.                                | 2.11 ∙  ¬    │ ╞═══────∙·· ·      ·
  615.                                | ··∙────═══╡ │ DMPC is a front end for  DMP │
  616.                                | │ and other players.  DMPC can │ │ read 
  617.                                | files  inside ARJ/ZIP/ │ │ LHA/LIMIT and
  618.                                | SQZ  archives. │ │ Supports all known
  619.                                | formats!! │ │ Allows  random  and   tagged │
  620.                                | │ playing.  Mouse support, EMS │ │ or  disk
  621.                                | swapping,  multiple │ │ configs,  a sample
  622.                                | ripper &  │ │ previewer for MOD, S3M, STM, │
  623.                                | │ 669,  MTM,  ULT,  FAR  & AMF │ │
  624.                                | formats.   Rips samples into │ │ SMP, RAW,
  625.                                | WAV,  SND and VOC. │ │ Multiple Directory
  626.                                | Support!! │ ╞═══────∙·· ·      · ··∙────═══╡
  627.                                | │ I need support  from the BBS │ │
  628.                                | community,  email  me if you │ │ can help
  629.                                | distro DMPC for me. │
  630.                                | ╘══════════════════════════════╛
  631.  
  632.  
  633.     The following produces a standard PCBoard directory, stripping
  634.     and wordwrapping the description.
  635.  
  636.     ; Total refit, standard PCBoard style
  637.     ;StartSameLine=YES
  638.     ;JustifyRight=YES
  639.     ;SingleWhite=YES
  640.     ;StripHigh=YES
  641.     ;WordWrap=YES
  642.     ;WrapLength=45
  643.     ;BlankLinesAfterName=0
  644.     ;BlankLinesAfterDesc=0
  645.  
  646.  
  647. DMPC211.ZIP     50852  04-11-94  Dual Module Player Companion Version 2.11
  648.                                | DMPC is a front end for DMP and other
  649.                                | players. DMPC can read files inside ARJ/ZIP/
  650.                                | LHA/LIMIT and SQZ archives.  Supports all
  651.                                | known formats!! Allows random and tagged
  652.                                | playing. Mouse support, EMS or disk
  653.                                | swapping, multiple configs, a sample ripper
  654.                                | & previewer for MOD, S3M, STM, 669, MTM,
  655.                                | ULT, FAR & AMF formats. Rips samples into
  656.                                | SMP, RAW, WAV, SND and VOC.  Multiple
  657.                                | Directory Support!! I need support from the
  658.                                | BBS community, email me if you can help
  659.                                | distro DMPC for me.
  660.  
  661.  
  662.     The following produces a "wide" files directory.
  663.  
  664.     ; Total refit, wide and expanded style
  665.     ;StartSameLine=YES
  666.     ;JustifyRight=NO
  667.     ;SingleWhite=YES
  668.     ;StripHigh=YES
  669.     ;WordWrap=YES
  670.     ;WrapLength=76
  671.     ;BlankLinesAfterName=0
  672.     ;BlankLinesAfterDesc=0
  673.  
  674. DMPC211.ZIP     50852  04-11-94  Dual Module Player Companion Version 2.11
  675.  | DMPC is a front end for DMP and other players. DMPC can read files inside
  676.  | ARJ/ZIP/ LHA/LIMIT and SQZ archives.  Supports all known formats!! Allows
  677.  | random and tagged playing. Mouse support, EMS or disk swapping, multiple
  678.  | configs, a sample ripper & previewer for MOD, S3M, STM, 669, MTM, ULT, FAR
  679.  | & AMF formats. Rips samples into SMP, RAW, WAV, SND and VOC.  Multiple
  680.  | Directory Support!! I need support from the BBS community, email me if you
  681.  | can help distro DMPC for me.
  682.  
  683.     The following produces a "wide and tall" file directory.
  684.  
  685.     ; Total refit, wide and expanded style
  686.     ;StartSameLine=NO
  687.     ;JustifyRight=NO
  688.     ;SingleWhite=YES
  689.     ;StripHigh=YES
  690.     ;WordWrap=YES
  691.     ;WrapLength=76
  692.     ;BlankLinesAfterName=1
  693.     ;BlankLinesAfterDesc=1
  694.  
  695. DMPC211.ZIP     50852  04-11-94  
  696.  |
  697.  | Dual Module Player Companion Version 2.11 DMPC is a front end for DMP and
  698.  | other players. DMPC can read files inside ARJ/ZIP/ LHA/LIMIT and SQZ
  699.  | archives.  Supports all known formats!! Allows random and tagged playing.
  700.  | Mouse support, EMS or disk swapping, multiple configs, a sample ripper &
  701.  | previewer for MOD, S3M, STM, 669, MTM, ULT, FAR & AMF formats. Rips samples
  702.  | into SMP, RAW, WAV, SND and VOC.  Multiple Directory Support!! I need
  703.  | support from the BBS community, email me if you can help distro DMPC for me.
  704.  |
  705.  
  706.     The following produces a "tall and thin" file directory.
  707.  
  708.     ; Total refit, wide and expanded style
  709.     ;StartSameLine=NO
  710.     ;JustifyRight=NO
  711.     ;SingleWhite=YES
  712.     ;StripHigh=YES
  713.     ;WordWrap=YES
  714.     ;WrapLength=34
  715.     ;BlankLinesAfterName=1
  716.     ;BlankLinesAfterDesc=1
  717.  
  718. DMPC211.ZIP     50852  04-11-94  
  719.  | 
  720.  | Dual Module Player Companion
  721.  | Version 2.11 DMPC is a front end
  722.  | for DMP and other players. DMPC
  723.  | can read files inside ARJ/ZIP/
  724.  | LHA/LIMIT and SQZ archives. 
  725.  | Supports all known formats!!
  726.  | Allows random and tagged playing.
  727.  | Mouse support, EMS or disk
  728.  | swapping, multiple configs, a
  729.  | sample ripper & previewer for
  730.  | MOD, S3M, STM, 669, MTM, ULT, FAR
  731.  | & AMF formats. Rips samples into
  732.  | SMP, RAW, WAV, SND and VOC. 
  733.  | Multiple Directory Support!! I
  734.  | need support from the BBS
  735.  | community, email me if you can
  736.  | help distro DMPC for me.
  737.  |
  738.  
  739. ╓─────────────────────────────────────────────────────────────────────────────╖
  740. ║ ░░░░░ Data Purging ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  741. ╙─────────────────────────────────────────────────────────────────────────────╜
  742.  
  743. The program will automatically purge databases of recieved file names
  744. after a specified number of days.  It is recommended you set this at
  745. 3-5 days, which gives enough time for full file processing and
  746. deletes file entries which may legitimately repeat such as
  747. 0000FFFF.MO1.  Additionally, you may specify a list of files which
  748. are -not- to be deleted from the databases, such as SHOW.EXE.
  749.  
  750.   PurgeDays=
  751.   NoPurgeList=
  752.  
  753. ╓─────────────────────────────────────────────────────────────────────────────╖
  754. ║ ░░░░░ Logging ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  755. ╙─────────────────────────────────────────────────────────────────────────────╜
  756.  
  757. The basic log levels are 1-5, where 5 give the most information and
  758. 1 gives the least.  Level 1 is basically errors, level 5 is tons
  759. of information (your log can grow quite large).  It is suggested you
  760. set the logging level at 5 to start and then reduce it later when you
  761. are assured everything is working to your satisfaction.
  762.  
  763.   SysopLog=
  764.  
  765.      Drive, path, name of the log file.
  766.  
  767.   LogLevel=
  768.  
  769.      1(Error), 2(Warning), 3(Major Info), 4(Minor Info), 5(Who Cares)
  770.      
  771.  
  772. ╓─────────────────────────────────────────────────────────────────────────────╖
  773. ║ ░░░░░ Program messages ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  774. ╙─────────────────────────────────────────────────────────────────────────────╜
  775.  
  776. SAT has the ability to write messages to a PCBoard message base of
  777. your choice, using an external message writing utility named TXT2MSG.
  778. The TO:, FROM: and SUBJECT: are currently fixed, but you can specify
  779. the text. 
  780.  
  781.   ProgramErrorMsg=
  782.  
  783.      Name of the file containing the text to use when SAT has detected 
  784.      an error condition.
  785.  
  786.   ProgramAlertMsg=
  787.  
  788.      Name of the file containing the text to use when SAT has detected 
  789.      an ALERT condition (see below).
  790.  
  791.   SysopMsgBase=
  792.  
  793.      The number of the conference where the message will inserted.
  794.  
  795. ╓─────────────────────────────────────────────────────────────────────────────╖
  796. ║ ░░░░░ File Moving and Tracking ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  797. ╙─────────────────────────────────────────────────────────────────────────────╜
  798.  
  799. This is where you specify the FROM, TO, FILESPEC, and METHOD of file
  800. moving.
  801.  
  802. FROM means the directory where the Planet Connect software will 
  803. place files recieved.
  804.  
  805. TO means where the SAT program is to move the files.
  806.  
  807. FILESPEC means which files to move; a DOS wildcard.
  808.  
  809. METHOD is four-fold:
  810.  
  811.    DELETE - always delete these files, do not move (although you must
  812.             specify at least a "placeholder" directory).
  813.  
  814.    NEWER  - move newer files of the same name, deleting the older.
  815.             If the file is identical to one already recieved, it is
  816.             deleted.
  817.  
  818.    RENAME - move newer files of the same name, renaming the older
  819.             in the format YY-MM-DD.ext, where ext is the original
  820.             file extent. Identical files are deleted.
  821.  
  822.             This is useful for Mail files; if the same name will
  823.             appear day after day, use this (HCNMAIL.ZIP comes to
  824.             mind).  If you neglect to process a Mail file, it
  825.             will not be overwritten, it will be renamed.
  826.  
  827.             If there are multiple file with the same extent, the
  828.             renaming will fail.  If for instance, you specify
  829.             LEDGE.QWK and INTELEC.QWK to go the the same place, and
  830.             miss a processing day, SAT will fail on trying to rename
  831.             two files to the same YY-MM-DD.QWK.  It is suggested 
  832.             that you move different networks to different places
  833.             and work with them from there.  If your mail processor
  834.             cannot handle multiple incoming directories, move the
  835.             incoming mail packets to the processing directory just 
  836.             prior to processing.
  837.            
  838.    ALERT  - same as RENAME, but also insert a message alerting you
  839.             to there being a new file. Identical files are deleted,
  840.             and no message is inserted.
  841.  
  842. Examples:
  843.  
  844.   Move=H:\PC\FIDO     H:\PC2\FIDO\MAIL 0000FFFF.*    NEWER
  845.   Move=H:\PC\FIDO     H:\PC2\FIDO\MAIL     CDN*.*    DELETE
  846.   Move=H:\PC\FIDO     H:\PC2\FIDO\FAM     FMLY*.*    RENAME
  847.   Move=H:\PC\FIDO     H:\PC2\FIDO\FILES       *.*    NEWER
  848.  
  849. MOVE's are processed in the order that they appear, so in the
  850. above example, all files matching the wildcard filespec of 
  851. 0000FFFF.* will be treated as NEWER (moved if newer, otherwise
  852. deleted).  Files matching CDN*.* (Christian Distribution Network) 
  853. will always be DELETE'd.  FamilyNet files will be moved if newer
  854. or deleted if identical; older files of the same name will be
  855. renamed.  All remaining files will be moved if newer, otherwise
  856. deleted.
  857.  
  858.   Move=C:\BRIDGE   M:\FIDO_IN   0000FFFF.*    NEWER
  859.   Move=C:\BRIDGE   M:\FIDO_IN       CDN*.*    NEWER
  860.   Move=C:\BRIDGE   M:\FIDO_IN      FMLY*.*    NEWER
  861.   Move=C:\BRIDGE   M:\FIDO_IN          *.*    NEWER
  862.  
  863. This would be redundant; only the last line is needed.  You only
  864. need specify more than one line per FromDir/ToDir if you need to
  865. process more than one FileSpec.
  866.